Bentley ProjectWise provides managed access to HAMMER CONNECT content within a workgroup, across a distributed organization, or among collaborating professionals. Among other things, this means that only one person is allowed to edit the file at a time, and document history is tracked. When a HAMMER CONNECT hydraulic model is stored using ProjectWise, hydraulic model files can be accessed quickly, checked out for use, and checked back in directly from within HAMMER CONNECT. With ProjectWise Explorer, it is possible to read the file's audit trail to determine who edited the file and when that occurred.

If ProjectWise Explorer is installed on your computer, HAMMER CONNECT automatically installs all the components necessary for you to use ProjectWise to store and share your HAMMER CONNECT projects. A HAMMER CONNECT hydraulic model consists of a *.wtg file, a *.wtg.sqlite file, and in the case of a standalone model a *.dwh file.

To learn more about ProjectWise, refer to the ProjectWise online help.

Follow these guidelines when using HAMMER CONNECT with ProjectWise:

• ProjectWise integration must be enabled before HAMMER CONNECT can directly interact with ProjectWise. Refer to the "Setting up ProjectWise Integration" section for more details.
• Once ProjectWise integration is enabled, use the normal Open/Save commands to access the ProjectWise datasources. A Datasource refers to a collection of folders and documents set up by the ProjectWise Administrator. The File > Open operation, for example, will first show the ProjectWise file browser, where you can open a hydraulic model that is already saved into ProjectWise. File > SaveAs can be used to save any hydraulic model into ProjectWise, whether it exists in ProjectWise or locally on your system's disk.
• The first time the ProjectWise prompt is opened in your current HAMMER CONNECT session, you are prompted to log into a ProjectWise datasource. The datasource you log into remains the current datasource until you change it via the ProjectWise tab of the Global Options in HAMMER CONNECT Tools. The user needs to know the name of the Datasource, a user name and a password.
• If a hydraulic model is opened from ProjectWise, then all subsequent open/save operations will prompt to open/save the file to ProjectWise first. At the ProjectWise prompt you can click the Cancel button to get a Windows file browse prompt if you want to pick a file on your local system or network. This applies to cases like import/export, as well as any other file selection operation such as picking a file for ModelBuilder to use, or referencing a file with Hyperlinks. If the current hydraulic model is not opened from ProjectWise however, you will only be allowed to choose files on your local system or network.
• Use the HAMMER CONNECT File > New command to create a new hydraulic model. The hydraulic model is not stored in ProjectWise until you perform a File > Save As operation.
• Use the HAMMER CONNECT File > Save command to save a copy of the current hydraulic model to your local computer.
• When you Close a hydraulic model already stored in ProjectWise using File > Close, you are prompted to select one of the following options: Check In—Updates the hydraulic model files in ProjectWise with your latest changes and unlocks the hydraulic model so other ProjectWise users can edit it. Unlock—Unlocks the hydraulic model files so other ProjectWise users can edit it but does not update the hydraulic model in ProjectWise. Note that this will abandon any changes you have made since the last Check-in command. Leave Out—Leaves the hydraulic model checked out so others cannot edit it and retains any changes you have made since the last server update to the files on your local computer. Select this option if you want to exit Bentley HAMMER CONNECT but continue working on the hydraulic model later. The hydraulic model files may be synchronized when the files are checked in later.
• In the HAMMER CONNECT Options dialog box, there is a ProjectWise tab with a Update server on Save check box. This option, when turned on, can significantly affect performance, especially for large, complex projects. When this is checked, any time you save your HAMMER CONNECT hydraulic model locally using the File > Save menu command, the files on your ProjectWise server will also be updated and all changes to the files will immediately become visible to other ProjectWise users. This option is turned off by default, which means the ProjectWise server version of the hydraulic model will not be updated until the files are checked in.
• Use the File > Update Server Copy command to update the files on your ProjectWise server with all changes made to the files, which will immediately become visible to other ProjectWise users. Note that this command saves the hydraulic model and any edits that have been made before it updates the ProjectWise files.
• In the SS2 release of HAMMER CONNECT, calculation result files are not managed inside ProjectWise. A local copy of results is maintained on the user's computer, but to ensure accurate results the user should recalculate desired scenarios for projects when the user first opens them from ProjectWise.
• HAMMER CONNECT projects associated with ProjectWise appear in the Most Recently Used Files list (at the bottom of the File menu) in the following format: pw://PointServer:_TestDatasource/Documents/TestFolder/Test1

Performing ProjectWise Operations from within HAMMER CONNECT

You can quickly tell whether or not the current HAMMER CONNECT hydraulic model is in ProjectWise or not by looking at the title bar and the status bar of the HAMMER CONNECT window. If the current hydraulic model is in ProjectWise, "pw://" will appear in front of the file name in the title bar, and a ProjectWise icon will appear on the far right side of the status bar, as shown here:

If you have enabled ProjectWise integration, you can perform the following ProjectWise operations from within HAMMER CONNECT:

1. In HAMMER CONNECT, select File > Save As.
2. If you haven't already logged into ProjectWise, you are prompted to do so. Select a ProjectWise datasource, type your ProjectWise user name and password, then click Log in.
3. In the ProjectWise Save Document dialog box, enter the following information: Click Change next to the Folder field, then select a folder in the current ProjectWise datasource in which to store your hydraulic model. Type the name of your HAMMER CONNECT hydraulic model in the Name field. It is best to keep the ProjectWise name the same as or as close to the HAMMER CONNECT hydraulic model name as possible. Keep the default entries for the rest of the fields in the dialog box. Click OK. There will be two new files in ProjectWise; a *.wtg and a *.wtg.sqlite.

To open a HAMMER CONNECT hydraulic model from a ProjectWise datasource from within HAMMER CONNECT:

1. Select File > Open.
2. If you haven't already logged into ProjectWise, you are prompted to do so. Select a ProjectWise datasource, type your ProjectWise user name and password, then click Log in.
3. In the ProjectWise Select Document dialog box, perform these steps: From the Folder drop-down menu, select a folder that contains HAMMER CONNECT projects. In the Document list box, select a HAMMER CONNECT hydraulic model. Keep the default entries for the rest of the fields in the dialog box. Click Open.

To open a HAMMER CONNECT hydraulic model from ProjectWise, it is also possible to double click on the hydraulic model in ProjectWise.

To copy an open HAMMER CONNECT hydraulic model from one ProjectWise datasource to another:

1. Select File > Open to open a hydraulic model stored in ProjectWise.
2. Go to Tools > Options, and on the ProjectWise tab click to change the default datasource.
3. In the ProjectWise Log in dialog box, select a different ProjectWise datasource, then click Log in.
4. Select File > Save As.
5. In the ProjectWise Save Document dialog box, change information about the hydraulic model as required, then click OK.

To make a local copy of a HAMMER CONNECT hydraulic model stored in a ProjectWise datasource:

1. Select File > Open.
2. If you haven't already logged into ProjectWise, you are prompted to do so. Select a ProjectWise datasource, type your ProjectWise user name and password, then click Log in.
3. Select File > Save As.
4. At the ProjectWise save prompt click Cancel.
5. Save the HAMMER CONNECT hydraulic model to a folder on your local computer.

To change the default ProjectWise datasource:

1. Start HAMMER CONNECT.
2. Select Tools > Options> ProjectWise tab.
3. Change the Default Datasource to the one you want to log into.

To use background layer files with ProjectWise:

• Using File > Save As-If there are background files assigned to the model, the user is prompted with two options: copy the background layer files to the hydraulic model folder for use by the hydraulic model, or remove the background references and manually reassign them once the hydraulic model is in ProjectWise to other existing ProjectWise documents.
• Using File > Open-Using this method, background layer files are not locked in ProjectWise for the current user to edit. The files are intended to be shared with other users at the same time.

To add a background layer file reference to a hydraulic model that exists in ProjectWise:

Using File > Save As-When you use File > Save As on a hydraulic model that is already in ProjectWise and there are background layer files, you are prompted with two options: you can copy all the files to the local hydraulic model folder for use by the hydraulic model, or you can remove the background references and manually reassign them after you have saved the hydraulic model locally.